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Objectives 


-  Distinguish  between  an  implicit  and  an 

expli^ife^  ty^^^^^^^^^ 
Explicit  Cursor  Functions  ^r^^^^^I 

-  Define,  Open,  Fetch,  Close  Cursor^^^ 
Controlling  Explicit  Ci^jsore^^^^^^ 

-  Explicit  Cursor  Attributes  \\^\^^>< 
Controlling  Multiple  Fetches 
Cursors  and  Records 


Cursor  FOR  Loops 

Cursor  FOR  Loops  using  Sub-queries 
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About  Cursors 


Every  SQL  statement  executed  by  the 
Oracle  Server  has  an  individual  cursor 
associated  wiaEfii Oft 

Implicit  cursors:  Declared  for  all 
DML  and  PL/ SQL  SELECT 
statements  /  A^^^^ 

Explicit  cursors:  Declared  and  named 
by  the  programmer  ^  \ 
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Explicit  Cursor  Functions 


Active  set 


7369 

SMITH 

CLERK 

7566 

JONES 

MANAGER 

7788 

SCOTT 

ANALYST 

7876 

ADAMS 

CLERK 

7902 

FORD 

ANALYST 

V 


Current  row 
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Controlling  Explicit  Cursors 
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Controlling  Explicit  Cursors 


Open  the  cursor. 


Fetch  a  row  from  the  cursor 


1 


i  i 


Continue  until  empty. 


Close  the  cursor. 
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Declaring  the  Cursor 


Syntax 


CURSOR  cursor_name  IS 
select  statement; 


Do  not  include  the  INTO  clause  in 
the  cursor  declaration. 

If  processing  rows  in  a  specific 
sequence  is  required,  use  the  ORDER 
BY  clause  in  the  query.  \^ 
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Declaring  the  Cursor 


Example 


DECLARE 

CURSOR  emp_cursor  IS 
SELECT  empno,  ename 
FROM      emp ; 

CURSOR  dept_cursor  IS 
SELECT  * 
FROM  dept 
WHERE     deptno  =  10; 
BEGIN 


•    •  • 


Copyright  ©  CD  AC- ACTS 


Advanced  Computing  Training  School  (ACTS) 
Advanced  Computing  for  Human  Advancement 


Opening  the  Cursor 
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-  Open  the  cursor  to  execute  the 
query  and  identify  the  active  set. 

If  the  query  returns  no  rows,  no 
exception  is  raised.  V^^T 

-  Use  cursor  attributes  to  test  the 
outcome  after  a  fetch. 


1^ 
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Fetching  Data  from  the  Cursor 


Syntax 


FETCH  cursor_name  INTO  [varlablel ,  var±able2, 
.  .  .  ]  |   record  name] ; 


Retrieve  the  current  row  values  into 
va^iSMe^ 

Include  the  same  number  of 
variables. 

Match  each  variable  to  correspond  to 
the  columns  positionally^T>^  \ 

Test  to  see  if  the  cursor  contains 
rows.  <^r— :  X — — v-C—- 

Copyright  ©  CD  AC- ACTS 


Advanced  Computing  Training  School  (ACTS) 
Advanced  Computing  for  Human  Advancement 


Fetching  Data  from  the  Cursor 


Examples 


END; 


•    •  • 


OPEN  defined_cursor; 
LOOP 

FETCH  def±ned_cursor  INTO 
def±ned_var±ables 
EXIT  WHEN   . . . ; 


•   •  • 


--  Process  the  retrieved  data 


•   •  • 


Copyright  ©  CD  AC- ACTS 


Advanced  Computing  Training  School  (ACTS) 
Advanced  Computing  for  Human  Advancement 


Closing  the  Cursor 
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Syntax 


Close  the  cursor  after  completing 
the  processing  of  the  rows. 

Reopen  the  cursor,  if  required. 


Do  not  attempt  to  fetch  data  from  a 
cursor  once  it  has  been  closed. 
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Explicit  Cursor  Attributes 


status  information  about  a 


iype 

L/l^oUl  ipilUII 

%ISOPEN 

Boolean 

Evaluates  to  TRUE  if  the  cursor 
is  open 

%NOTFOUND 

Boolean 

Evaluates  to  TRUE  if  the  most 
recent  fetch  does  not  return  a  row 

%FOUND 

Boolean 

Evaluates  to  TRUE  if  the  most 
recent  fetch  returns  a  row; 
complement  of  %NOTFOUND 

%ROWCOUNT 

Number 

Evaluates  to  the  total  number  of 
rows  returned  so  far 
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Controlling  Multiple  Fetches 


Process  several  rows  from  an  explicit 
cursor  using  a  loop.  c^^^^VI^^^^ 

Fetch  a  row  with  each  iteration.  ^ 

Use  the  %NOTFOUND  attribute  to 
write  a  test  for  an  unsuccessful 

Use  explicit  cursor  attributes  to  test 
the  success  of  each  fetch. 
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The  %ISOPEN  Attribute 
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-  Fetch  rows  only  when  the  cursor  is 

^^eii^^^^^^J--^^^^^^^^^^^^^ 

Use  the  %ISOPEN  cursor  attribute 
before  performing  a  fetch  to  test^f 
whether  the  cursor  is  o|£e2^^>^/ 


IF  NOT  emp_cursor%ISOPEN  THEN 

OPEN  emp_cursor; 
END  IF; 
LOOP 

FETCH  emp_cursor . . . 
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The  %NOTFOUND  and  %ROWCOUNT  Attributes 


Use  the  %ROWCOUNT  cursor 
attribute  to  retrieve  an  exact  number 
of  rows.)>>^|^  -^<^ 
Use  the  %NOTFOUND  cursor 
attribute  to  determine  when  to  exit 
the  loop. 
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Cursors  and  Records 


Process  the  rows  of  the  active  set 
conveniently  by  fetching  values  into  a 

pl/ sql  record:^T  x  'l  \.V . 

Example       M  1^3^^ 


DECLARE 

CURSOR  emp_cursor  IS 
SELECT  empno,  ename 
FROM      emp ; 
emp_record  emp_cursor%ROWTYPE ; 
BEGIN 

OPEN  emp_cursor ; 
LOOP 
FETCH 


emp_cursor  INTO  emp_record; 
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Cursor  FOR  Loops 


Syntax 


FOR  record_name  IN  cursor_name  LOOP 
statementl ; 
s  ta  temen t2 ; 


END  LOOP; 


The  cursor  FOR  loop  is  a  shortcut  to 
process  explicit  cursors.  \  J^S^^^ 


r  / 


Implicit  open,  fetch,  and  close  occur. 
The  record  is  implicitly  declared. 
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Cursor  FOR  Loops 


•  Retrieve  employees  one  by  one  until  no 
more  are  le^^^^^^^^^^C^ 

Example  ~y^f       AP  3TcR^Ff^^\ 


DECLARE 

CURSOR  emp_cursor  IS 
SELECT  ename,  deptno 
FROM      emp  ; 

BEGIN  7 
FOR  emp_record  IN  emp_cursor  LOOP 
--  implicit  open  and  implicit  fetch  occur 
IF  emp_record . deptno  =  30  THEN 

•    •  • 

END  LOOP;   --  implicit  close  occurs 
END; 
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Cursor  FOR  Loops  Using  Sub-queries 


•  No  need  to  declare  the  cursor. 

•  Example  ^^^^ 


BEGIN 

FOR  emp_record  IN   (SELECT  ename,  deptno 

FROM  emp) 

LOOP 

--  implicit  open  and  implicit  fetch  occur 
IF  emp_record. deptno  =  30  THEN 


•   •  • 


END  LOOP;  --  implicit  close  occurs 
END; 


Copyright  ©  CD  AC- ACTS 


Advanced  Computing  Training  School  (ACTS) 
Advanced  Computing  for  Human  Advancement 


Summary 
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Cursor  types^^-zzziijzii— 

Implicit  cursor^^J^^^^^^^^^^ 

Explicit  cursorsk  ft  3TcR^^^y^^^^ 

You  can  evaluate  the  cursor  status  by 
using  cursor  attributes^^<\^^^^ 

You  can  use  cursor  FOR  loops 

You  can  define  cursors  with  sub-queries 
and  correlated  sub-queries. 

V  \J      \  yC^XL  ^ 
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Thank  You  ! 
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